home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / gen / frgen13 / frgen.doc < prev    next >
Encoding:
Text File  |  1992-11-29  |  6.9 KB  |  146 lines
  1.                    Fractal Landscape Generator v1.3
  2.                     Copyright (c) 1992 Steve Anger
  3.                  This program is freely distributable
  4.  
  5.   FRGEN is a utility to generate fractal landscapes and other shapes
  6. using successive triangle sub-division. The fractal data can be output
  7. as POV-Ray 1.0 or Vivid 2.0 scene files or as raw triangle data. FRGEN
  8. only generates flat faceted triangles. To produce smoothed fractals you
  9. can output the fractal to RAW format and then run the data through the
  10. programs Sandpaper (Vivid, MTV, Rayshade) or raw2pov (POV-Ray).
  11.  
  12. Changes in v1.3
  13. - modified for POV-Ray 1.0 and Vivid 2.0 output format.
  14.  
  15. Changes in v1.2
  16. - replaced DKB output with PoV output.
  17. - added Vivid and raw triangle output formats.
  18.  
  19. Changes in v1.1
  20. - you can now start the fractal generation from any arbitrarily
  21.   specified set of base triangles instead of the simple square base
  22.   which was used in v1.0. You can now generate fractal spheres, boxes,
  23.   specifically shaped mountain ranges, etc.
  24.  
  25. - the program will now create an efficient set of bounding shapes for
  26.   the huge number of triangles generated. Scenes generated with v1.1
  27.   will typically render 5 to 10 times faster than those generated with
  28.   v1.0
  29.  
  30. - the 3D projection is now much more accurate, plus you can specify the
  31.   view-point and look-at coordinates instead of just the viewing angle.
  32.  
  33.  
  34. OPERATION
  35.  
  36. Usage: frgen infile[.fr] outfile[.ext] [[-,/]options]
  37.  
  38. Options: -sxnnn   Scale noise in x direction by nnn (0.0 - 1.0)
  39.          -synnn     '     '    ' y     '      '  '     '     '
  40.          -sznnn     '     '    ' z     '      '  '     '     '
  41.          -bxnnn   Bias noise in  x direction by nnn (-1.0 - 1.0)
  42.          -bynnn     '    '    '  y     '      '  '     '     '
  43.          -bznnn     '    '    '  z     '      '  '     '     '
  44.          -vxnnn   Set view_point x coord to nnn
  45.          -vynnn    '      '      y   '    '  '
  46.          -vznnn    '      '      z   '    '  '
  47.          -lxnnn   Set look_at x coord to nnn
  48.          -lynnn    '     '    y   '    '  '
  49.          -lznnn    '     '    z   '    '  '
  50.          -ennn    Use nnn as seed for random number generator
  51.          -rnnn    Maximum recursion depth of nnn
  52.          -d       Preview generated fractal on screen
  53.          -o[n]    Set output format (-op = PoV, -ov = Vivid, -or = raw)
  54.          -x       Exchange Y and Z coordinates on output
  55.  
  56. ex. C>frgen sphere.fr fract.dat -d -r2
  57.  
  58. infile[.fr]    This is the file which contains the basic specifications
  59.                for the fractal. The first non-comment line of this file
  60.                is a list of default options for this fractal (comment
  61.                lines begin with a semi-colon). This line must be
  62.                present. The rest of the file contains a list of
  63.                coordinates for the triangles making up the base from
  64.                which the fractal grows. The coords of the triangles are
  65.                specified one per line in the following format:
  66.  
  67.                 ax ay az  bx by bz  cx cy cz  [fix_ab  fix_bc  fix_ca]
  68.  
  69.                The numbers ax, ay, etc. are the x,y,z coordinates of the
  70.                three vertices of the triangles. The three optional
  71.                numbers fix_ab, fix_bc, and fix_ca can be either 1 or 0
  72.                and specify  whether that edge of the triangle is forced
  73.                to stay within the plane of the triangle or allowed to
  74.                move freely (1 = fixed, 0 = free). The most common use
  75.                for 'fixed' edges is to force  the outer edges of a
  76.                mountain base to stay on the ground. If not specified,
  77.                edges are assumed to be free.
  78.  
  79.                e.g.
  80.                     ; The default options are on the following line
  81.                     -sx0.1 -sy0.2 -sz0.1 -by0.5 -r4 -vx10 -vy5 -vz-10
  82.                     ; Two triangles in the x-z plane making up the base 
  83.                     ; of a mountain
  84.                     +10.0 0.0 0.0   0.0 0.0 +10.0  -10.0 0.0 0.0  1 1 0
  85.                     -10.0 0.0 0.0   0.0 0.0 -10.0  +10.0 0.0 0.0  1 1 0
  86.  
  87.                Three sample input files are included:
  88.                mountain.fr - Square based mountain.
  89.                diamond.fr  - Simple diamond shape made of 8 triangles.
  90.                sphere.fr   - Sphere made from 48 triangles.
  91.  
  92. outfile[.ext]  Output file to be created. The extension added will
  93.                depend on the output format specified.
  94.  
  95. -sx -sy -sz    These three numbers specify the magnitude of the noise
  96.                that will be used to perturb the triangles. Setting a
  97.                scaling factor of 0.0 (-sx0 -sy0 -sz0) will generate a
  98.                fractal that is unchanged from the starting shape while
  99.                a scaling factor of 1.0 (-sx1.0 -sy1.0 -sz1.0) will
  100.                create extremely distorted shapes. Values in the range
  101.                0.05 to 0.25 usually work well. Default values are -sx0.1
  102.                -sy0.1 -sz0.1
  103.  
  104. -bx -by -bz    These numbers specify the amount by which the noise is
  105.                biased in the corresponding x,y,z direction. A positive
  106.                value will cause the noise to tend to move in the
  107.                positive direction of  the axis while a negative value
  108.                will tend to move it in the opposite direction. e.g. If
  109.                start with a triangle in the x-z plane, a setting of
  110.                -bx0.0 -by0.5 -bz0.0 will cause the fractal to tend to
  111.                bulge upward creating a mountain-like shape. Default
  112.                values are -bx0.0 -by0.0 -bz0.0
  113.  
  114. -vx -vy -vz    The x, y, and z coordinates of the viewpoint. Used for
  115.                screen preview only.
  116.  
  117. -lx -ly -lz    The x, y, and z coordinates of the point you are looking
  118.                at. Used for screen preview only.
  119.  
  120. -e             You can use this option if you want to manually specify
  121.                the seed used by the random number generator. This is
  122.                useful if you want to reproduce the same fractal more
  123.                than once but using different view points, numbers of
  124.                triangles, etc.
  125.  
  126. -r             This specifies the number of times to sub-divide the
  127.                triangles. Be careful when setting this number as the
  128.                number of triangles generated will increase by a factor
  129.                of 4 every time it is increased by 1. Default is -r3
  130.  
  131. -d             Turns the display preview on.
  132.  
  133. -op            Selects PoV output format (default).
  134.  
  135. -ov            Selects Vivid output format.
  136.  
  137. -or            Selects raw triangle output format.
  138.  
  139. -x             This option causes the Y and Z coordinates to be switched 
  140.                when writing the output file. This is useful if your    
  141.                rendering package uses the Z axis as vertical instead of 
  142.                the Y axis.
  143.  
  144.                                               CompuServe: 70714,3113
  145.                                                YCCMR BBS: (708)358-5611
  146.